Cream of the Crop 20/Cream of the Crop 20 (Terry Blount) (1996).iso/comm/nuvread2.zip/NUVAREAD.TXT

Text File | 1996-06-09 | 14KB | 325 lines

******************************************************************

:           NUVAREAD SHAREWARE UTILITY Ver.2 & 3

              by P.Mihok  -  June 1996



*****************************************************************

:PRELIMINARY:

   Nuvaread has proven to be a popular program for displaying text
 as it works on any machine and is highly customizable. Translated
 into many languages, and customized in many ways, it is finding
 a niche in all sorts of text display systems. People are enthusiastic
 about the automated highlight menu, the quick search, the mouse
 operation, and the ability to provide all sorts of custom shells
 and command line switches on demand.

   The current release includes a version which loads into RAM rather
 than loading actively from the disc, and which provides a wider range
 of colour selections, a different highlight system, etc.

 NOTE - one reason for this new release is to notify users of our
 new fax number! 905-471-3217

:0>:INTRODUCTION to NUVAREAD:

   People who have previously tried VAREAD and found it was not
 quite suitable for distributing documentation, may be interested in
 NUVAREAD, which offers many more features as well as affording
 much better printing. NUVAREAD is mouseable, and gives an automated
 menu and also line highlighting, so it is very easy to create a useable
 document with it as well as to navigate around the file. NUVAREAD,
 like VAREAD, handles files up to 10,000 lines long; since I simplified
 the file loading, it loads much faster. (It doesn't auto wrap at the
 last space in a line, however. It just wraps at the end of the screen.
 VAREAD does autowrap, but I felt it took too long to load.) I have made
 versions which scroll to the left or right, which handle tables in a
 special manner, and which read in a different manner - loading into
 RAM rather than actively reading from the disc; hypertext versions,
 versions with custom FIND lists, etc.

    I have also provided full colour (text mode) graphics incorporated
 into the files, such as those drawn by VmASC. Thus one could have up to
 100 fully coloured title screens at any point in the file, for instance.

 (VmASC is in IBMAPP on COMPUSERVE, and its registration number is 7877)

   You could look for CYBRTEXT which is a version with a different menu
 system, a FIND list, and lots of hypertext capabilities!

**************************************************************

:1>:LOADING NUVAREAD:

    The utility can be summoned by typing

    NUVAREAD

 at the command line, in which case it looks for a file named
 NUVAREAD.TXT. (If there is no file, it complains.)

    Typing a file name after the name of the utility,

    NUVAREAD YOURFILE.TXT

 will load the specified file. Try not to use NUVAREAD to read unusual
 files (non ASCII) as it might not work right. (I haven't found anything
 that perturbs it unduly, however.)

    The utility will display ASCII files of up to 10,000 lines in
 length. It will truncate and wrap long lines, so long files with long
 lines may not be shown beyond the 10,000 (wrapped) length.

    It also loads a shell if provided.

    The utility shows you the first screen as it loads the file, so
 you can start reading right away as it is loading.

:2> DESCRIPTIONS:
:(a) HIGHLIGHT LIST/MENU:

  Hitting F10 will show a highlight list/menu which is created from
 one of the following:

     i) - if the documentation contains built-in highlights, created
 by placing a colon in the first column as shown:
 : (This would be a highlighted line if the colon were placed at the
 start of the line...)

     NUVAREAD will highlight the line when it is displayed and also
 show the line in the highlight list, which can be scrolled like a
 menu and from which you can move to any of the listed lines within
 the body of the text.

     ii) - if no such highlights have been provided, NUVAREAD will
 look for lines which might be title lines, seeking out isolated lines
 and listing them in the highlight list. I'm not entirely happy with
 the way this works, though, since everyone seems to have their own
 ideas of how a title line should be, so it's unpredictable what you
 will get.

     NUVAREA2 provides highlights based on lines which start at column
 zero, instead of having a colon. This version is a modified version of
 a recent customization, included to show some of the potential of
 NUVAREAD.

    Using the up down arrows or the mouse button, you can select a
 line in the highlight list and then ENTER or the Left mouse button will
 go there, or ESC or the right mouse button will escape the list.
 The list scrolls with the mouse cursor on the top or bottom line.

    The highlight list only handles 100 lines of highlight.

:(b) SHELL OPTION:

 If the name of a shell file is loaded at the command line as follows:

     NUVAREAD YOURFILE.TXT &BINGO

     NUVAREAD will then shell out and try to run the file named "BINGO"
 when F2 is hit. (The ampersand flags that it is the shell name.)

     If no shell file has been loaded, NUVAREAD will simply not respond
 to this key.
    (The shell now loads a copy of DOS if it doesn't find a shell,
 in response to user request! Hopefully COMMAND.COM is in your user's
 current path. No harm done if it isn't...)

     (A shell file is another file which you want the user to be able
 to run concurrently with the current one. For instance, a self-
 displaying diagram or illustration named PICTURE.EXE might be your
 shell file. Customized versions which provide multiple shell files
 responding to function keys or the mouse, easily defined in a separate
 text file, have been provided for some users.)


:(c) HELP:

- an improved help screen is now provided (hit F1). It provides a much
 more detailed description of the navigation and other options, and
 explains all the functions.

      As a programmer, I always regretted having to enlarge my file
 size by incorporating a lot of HELP text, but my newest software
 includes context sensitive full screen help and I realized that it
 can be really nice to have it. However there isn't really a reason
 to add much help to a simple utility like this.


:(d) ABOUT:

 - an ABOUT THIS FILE screen is now provided (hit Alt-A or F9).

 - HELP files, labels etc. customized for language or special user
 requirements have been provided on request to registered users.

    VAREAD's file information was rather obtrusive into the reader's
 reading experience, so I decided to place it in its own function and
 keep clear the screen that the user sees in NUVAREAD.

    The exit screen has a two second delay tied to the system clock,
 and says the software is unregistered as well as giving ABOUT
 information. I regret having to add stuff like this, but if you
 register, it will be gone! Please be honest and register -- I am
 really not asking very much for standard registration fees.

:AND IF YOU GO AWAY...

    The software now has a screen saver which comes up after 5 minutes
 of no user input.


:(e) WORD SEARCH:

   NUVAREAD will provide an edit box where you can type the
 word you wish to find, if you hit F (for Find.) The search is quite
 fast. Hitting ENTER or the left mouse button starts the search from
 the beginning of the file or Alt F from the current location, and
 ENTER or the left button causes it to go onward to the next match.
 The right mouse button or ESC stops search.

   You can now type longer strings with spaces, and hit "b" if you
 want to go back to the previously found string. (only one button
 deep memory, though.) (CYBRTEXT gives you a list of strings that
 were found, and other options are also available. These features
 are also available in NUVAREAD.)

   I supplied BOOLEAN find to several users, also to VLIST
 (VLIST is in IBMAPP and its registration number is 7833. A faster
 version of VLIST, with extended directory capability, is in the
 works, by the way.)

:(f) PRINTING:

  Two cascaded